home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 23.zip / BS1 part 23 / The CD Store v1.6.adf / CDStore.DOC < prev    next >
Text File  |  1991-06-15  |  14KB  |  396 lines
  1.                      <*>     CDStore Version 1.6   <*>
  2.                                by John Lullie
  3.                                Copyright 1990
  4.  
  5.  
  6.  
  7. CDStore was designed to help keep track of all the Compact Disks
  8. you own. It may be worth the effort if you belong to a CD Club
  9. or if you have so many CDs that you're not sure any more what
  10. you have. This application was written in `CanDo' - A GREAT
  11. development tool from Inovatronics.
  12.  
  13. CDStore is the sequel to `VideoStore' which will keep track of
  14. your Movie/Video library. The user interface is about the same
  15. but VideoStore is dedicated to Movies and Videos tapes.
  16.  
  17. --------------------------------------------------------------
  18. CDStore is ShareWare! You may upload it anywhere you choose
  19. provided that you please keep all the files together.
  20. If you decide to use CDStore - PLEASE send a ShareWare
  21. fee of $10. In return, I'll send you the upgrade for CDStore,
  22. a copy of VideoStore and a Laser printed Users Guide for both!
  23.  
  24. Please send to:
  25.  
  26.     John Lullie
  27.     10701 SW 10th Court
  28.     Davie, FL   33324
  29.  
  30. Thanks!
  31. --------------------------------------------------------------
  32.  
  33. This program was written entirely in `CanDo' from Inovatronics.
  34. A Fantastic piece of software and an invaluable development tool!
  35. My thanks go out to everyone at Inovatronics for making Amiga
  36. programming fun!!
  37.  
  38. If you've downloaded CDStore from a BBS or National Network, the
  39. archive should contain ALL of the following files:
  40.  
  41.   CDStore1.6    - The main program. May be placed anywhere in
  42.                   your system.
  43.   CDStore1.6.info - The Icon for CDStore. Double click to load the
  44.                     program.
  45.   CD-RECORD     - The data-file. Your CD information will be stored
  46.                   here. The Installer will put this file into your
  47.                   `SYS:S/' directory (Must be there to work)
  48.   CDStore.DOC   - The file you are reading now.
  49.   DeckRunner    - Default tool to run CDStore. The Installer will put
  50.                   this file in your 'SYS:C/' directory.
  51.   CDStore.Install - CDStore Installer program. This will automate the
  52.                   installation.
  53.  
  54. If you are missing any of these files, you can contact me on
  55. `American People Link' and I will upload the needed file(s)
  56. for you.
  57. PLINK USER ID =   J.LULLIE
  58.  
  59.  
  60. If you don't like to read DOC files, you can skip ahead to the
  61. "QuickStart" section, use the references and browse through the
  62. program. The "Getting Started" section below is a tutorial. It
  63. is much more descriptive of the features in CDStore and will
  64. quickly walk you through all of the functions.
  65.  
  66.  
  67. *---------------------------*
  68.  GETTING STARTED (TUTORIAL):
  69. *===========================*
  70.  
  71. Once you have decompressed the archive, double-click on the
  72. `CDStore.Install' icon. The Installer will copy the needed files
  73. to their proper places. `CDStore' will run from anywhere so you can
  74. copy it to any place you like by either dragging it into a directory
  75. using the mouse or by copying it with a utility program.
  76.  
  77.  
  78. When you are ready to start, double-click the `CDStore' icon
  79. to start the program. You are presented with the CDStore screen.
  80. This screen has all the tools needed to add, edit, trash, print,
  81. count and search CDs (record entries).
  82.  
  83. ---------------------------------
  84. THE LIST WINDOW AND MODE BUTTONS:
  85. =================================
  86.   On the left half of the screen you'll see the `List Window'.
  87.   This window holds the entire record of all the current CDs
  88.   stored. These records are stored in a file called `CD-RECORD'
  89.   that resides in your 'SYS:S/' directory.
  90.   The two Mode buttons (above the List Window:
  91.   Titles & Artists) tells CDStore to display the `Titles'
  92.   or `Artists' of the stored CDs. Titles for instance would be
  93.   "Abbey Road" and Artist(s) would be "The Beatles".
  94.  
  95.   The default entry "Abbey Road" has already been entered and
  96.   is displayed for you. Click on the `Artists' button to see
  97.   the Artists listed in the window ("The Beatles" in this case).
  98.  
  99.   Click the `Titles' button to bring the title "Abbey Road" back
  100.   to the List Window. Now click once on the Title "Abbey Road"
  101.   in the List Window - you will see both the Title and Artist
  102.   displayed in the two fields alongside the List Window. Also,
  103.   you may have noticed that each time you click on either button
  104.   (Titles or Artists) the Status Box (located on the right of
  105.   the screen) tells you what is happening. This Status Box displays
  106.   different information depending the mode of operation; Adding,
  107.   Editing, Searching etc. It will also display a  requester when
  108.   you try to trash (delete) a record, continuing or canceling
  109.   searches.
  110.  
  111.  
  112. ----------------
  113. Adding a new CD:
  114. ================
  115.  
  116.   QUICK NOTE ABOUT RECORD FILING:
  117.     The entries you type in are written directly to the file
  118.     "S:CD-RECORD" AFTER pressing return in the second field
  119.     called "Artist". Therefore, there is no menu option or
  120.     button for saving the file, it is done automatically.
  121.  
  122.   To add a new CD, click once on the `Add CD' button located
  123.   at the top of  the screen. The Status Box will display "Add
  124.   a New CD...", the two fields (Title & Artists) will be cleared
  125.   and the cursor will be placed into the Title field ready for
  126.   your input.
  127.   Enter a new title for your CD and press return (for this tutorial,
  128.   entering any text will do). The cursor will be placed into the
  129.   Artists field ready again for your input.
  130.   Enter the artist of your new CD and press return.
  131.   Your new entry will be entered into the List Window and saved
  132.   to your record file.
  133.  
  134. NOTE: When `Adding' or `Editing' records you must press
  135. [RETURN] in the `Artist' field for the new or edited records
  136. to be accepted. After which, your new record will be displayed
  137. in the List window and saved to your record file on disk.
  138.  
  139.  
  140. --------------
  141. TRASHING A CD:
  142. ==============
  143.  
  144.   To Trash or delete a CD from the record, you need to select
  145.   a CD in the List Window, then click on the `Trash CD' button.
  146.   Select `Abbey Road' in the List Window and click the `Trash CD'
  147.   button. A file requester will pop up in the Status Box and give
  148.   you a chance to change your mind.
  149.   If you click `Cancel' - the requester will disappear and leave
  150.   `Abbey Road' untouched.
  151.   If you click `Ok' - you can say bye bye to the `Abbey Road'
  152.   entry.
  153.  
  154.  
  155. -----------------------
  156. EDITING A RECORD ENTRY:
  157. =======================
  158.  
  159.   To Edit a record, click on the `Edit CD' button and
  160.   select the entry you want to edit in the List Window.
  161.   For example, select the entry you made earlier in this tutorial.
  162.   (If you haven't added one and the List window is empty, follow
  163.   the example above under "Adding a new CD". Otherwise select any
  164.   entry.) Once a record has been selected, it will be displayed in
  165.   the Title and Artists fields ready for editing.
  166.   You may now make any changes to the entries (Title and Artists).
  167.   After you've made the change, press return and the cursor
  168.   will be put in to the Artists field. You can edit the entry in this
  169.   field also or just press return.
  170.  
  171.  NOTE: Your changes will be entered AFTER you have pressed the
  172.        return key in the Artists field. If you do not wish to edit
  173.        anything in the Artist field, simply press return.
  174.  
  175.  
  176. -----------------------
  177. SEARCHING FOR AN ENTRY:
  178. =======================
  179.  
  180.   Clicking on the `Search' button will put the cursor into
  181.   the Title field and await your input. Type in either
  182.   the Title name or Artist(s) name that you want to find
  183.   and press return. The search will begin and stop at the
  184.   first instance that matches what you've entered. If the
  185.   text you entered WAS found - you'll be prompted by a
  186.   requester to continue the search for the next match or
  187.   cancel the search all together.
  188.   You don't have to enter the entire name for the search
  189.   to be effective, nor is it case-sensitive. For example,
  190.   If we were looking for "Star Wars" - we could simply type
  191.   "star" (without the quotes of course) and CDStore
  192.   would stop at every record that contained the letters
  193.   "star". (i.e. - "Star Trek", "Star Wars", "Starbuck",
  194.   "Shining Star" and so forth). The more characters you
  195.   type in - the more narrow the search is.
  196.   The search applies to either field and does not matter
  197.   which field you type in your search text. Searching applies
  198.   to Artists as well as Titles.
  199.  
  200.  
  201. ----------------
  202. SORTING RECORDS:
  203. ================
  204.  
  205.   Clicking on the `Sort' button will sort your records in
  206.   alphabetical order by title and then refresh the List window.
  207.  
  208.  
  209. -----------------
  210. PRINTING RECORDS: (New to Version 1.6)
  211. =================
  212.  
  213.   Clicking on the `Print' button will open the Print/
  214.   Page-Setup window. You will see two Format Icons at
  215.   the top of this window as well as Line Space options'.
  216.   You will also see a Preview window below that displays
  217.   your current records in the format selected.
  218.   To the left and right (upper half) of the screen are two more
  219.   buttons - `Print' and `Exit':
  220.  
  221. -Format Icons:
  222.  -------------
  223.  These icons control the print format of your records.
  224.  
  225.  * The first icon will print each record on a single line.
  226.  * The second icon will print each record on two lines.
  227.  
  228.  The formats are as follows:
  229.  
  230.                 1-Line    "Title, Artist(s).name"
  231.                 2-Lines   "Title,
  232.                            Artist(s).name"
  233.  
  234.  Simply click once on one of the icons and the Preview
  235.  window will display the change accordingly.
  236.  
  237. -Record Line Spacing (On/Off):
  238.  -----------------------------
  239.  Just below the Format icons you'll see the ` Record Line Space'
  240.  options (On/Off):
  241.  
  242.  `On'  - will insert a blank line between each record for
  243.          a more legible printout.
  244.  `Off' - will remove blank lines if they are there and the
  245.          printout will have NO blank lines between records.
  246.  
  247. -`Print' Button: (In the Page-Setup window):
  248.  ---------------
  249.          (Make sure your printer is on and ready.) This button will
  250.          print the records to your printer using the format options
  251.          you've selected.
  252.  
  253. -`Exit' Button:
  254.  --------------
  255.          This button will exit the Print/Page-Setup and return you
  256.          to CDStore's main window.
  257.  
  258.  
  259.  
  260. -------------------------------------------------------------------
  261.  
  262. * =========== *
  263.    QUICKSTART:
  264. * =========== *
  265.  
  266.     This section of the DOC is a brief reference to the
  267.     functions in CDStore.
  268.  
  269.  
  270. ---------------------------------------------
  271. CDSrore MENUS, SCREEN-OBJECTS AND BUTTONS:
  272. =============================================
  273.  
  274. Menus:
  275.  
  276.  `About'  - Shows program version and other info.
  277.  
  278.  `Quit'   - Exits CDStore.
  279.  
  280.  `Edit'
  281.      `Undo Trash'  - Undeletes the last deleted record.
  282.  
  283.         Whenever an entry is deleted, it is copied to a buffer
  284.         and held there until another entry is deleted.
  285.  
  286.      `Sort' - Sorts Records
  287.  
  288.         Selecting `Sort' in the Edit menu will sort your records in
  289.         alphabetical order by Title and update the List window.
  290.  
  291.      `Clear Fields' -  (New to Version 1.6)
  292.  
  293.         Clears the Title and Artist fields. This will not delete
  294.         any records but simply clear anything currently the
  295.         fields.
  296.  
  297.      `Refresh List' - Strips blank record entries.
  298.         (New to Version 1.6)
  299.  
  300.         Strips blank entries from the file `CD-RECORD' and
  301.         reloads the file. If you enter a blank record, CDStore
  302.         will see it and stop feeding the stored entries into
  303.         the List window. This does not mean that the data is
  304.         lost - only that there is a blank entry in your record.
  305.         Selecting `Refresh List' will correct the file and
  306.         feed ALL of your entries back into the window.
  307.         I'm certain I've eliminated the possibility of blank lines
  308.         occuring again but the Refresh option is there if you ever
  309.         need it. (`Refresh List' is temporary and will be built in
  310.         and automatic in the next release).
  311.  
  312.  
  313. ---------------------------
  314. CDStore BUTTON DEFINITIONS:
  315. ===========================
  316.  
  317.  Quit     - Close box in the upper left hand corner of the screen.
  318.  
  319.  Print    - Opens the Print/Page-Setup window. (New to Version 1.6)
  320.  
  321.  Edit CD  - Allows you to Edit CD entries.
  322.  
  323.  Add CD   - Add a new CD to the list.
  324.  
  325.  Trash CD - Deletes the currently selected CD.
  326.  
  327.  Titles   - Displays Title names in the List window.
  328.  
  329.  Artists  - Displays Artists in the List window.
  330.  
  331.  Search  -  Search for a CD entries.
  332.  
  333.  
  334.  
  335. -----------------------------
  336. List Window and Mode Buttons:
  337. =============================
  338.  
  339.   This window displays CD Titles or Artists depending on the
  340.   Mode button selected. In either case, both the Titles and
  341.   Artists will be displayed in their respective field when
  342.   selected from the List window (see Fields and their
  343.   Functions below).
  344.  
  345.   (The selected mode will be highlighted by an "X" mark located
  346.   inside each button.)
  347.  
  348.  `Titles' Button:
  349.         Displays Titles in the List window.
  350.  
  351.  `Artists' Button:
  352.         Displays Artists in the List window.
  353.  
  354.  
  355. ---------------------------
  356. Fields and their Functions:
  357. ===========================
  358.  
  359.   Title:
  360.        - Displays a selected Title.
  361.        - Add or Edit a selected Title.
  362.        - Used for entering text when Searching
  363.          for a particular Title.
  364.  
  365.   Artists:
  366.        - Displays a selected Artist.
  367.  
  368.  
  369.  
  370. Other CDStore Objects:
  371. ------------------------
  372.  
  373.   Status Box:
  374.        - Displays information about the current state of the
  375.          program and other mode information.
  376.  
  377.   Total CDs Box:
  378.        - Keeps track of the total CDs entered in CDStore.
  379.  
  380.  
  381. That's about it for now...
  382.  
  383. My thanks go out to the Beta testers;
  384.    Linda Palermo Lullie (My wife and Author of `FoodProcessor')
  385.    James Canfield
  386.    Anthony Mirabele
  387.    Jim Bruno
  388.    and Doug Mitchel
  389.  
  390. Any bug reports, suggestions or comments may be sent to me
  391. via PeopleLink:
  392. User ID - J.LULLIE.
  393.  
  394. Hope you find CDStore useful!
  395.  
  396.